home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / utils1 / dfat26.arj / DFAT.DOC next >
Text File  |  1994-01-25  |  10KB  |  222 lines
  1.  
  2.                                DFAT 2.6
  3.                        [short for Directory FAT]
  4.  
  5.                 Shows file clusters in directory groups
  6.  
  7.                                   by
  8.                                Bob Eyer
  9.                         Compuserve [73230,2620]
  10.                   INTERNET: 73230.2620@compuserve.com
  11.  
  12.                            January 25, 1994
  13.  
  14.      ┌────────────────────────────────────────────────────────────────┐
  15.      │                                                                │
  16.      │     Like  the  idea  of a BBS program that works at a basic    │
  17.      │     level with no configuration  at  all--a  miniature  BBS    │
  18.      │     which  can  be  made  as sophisticated as you like, but    │
  19.      │     which can be run as a simple utility if you forget  how    │
  20.      │     to use it?  Try HOSP.  Lots of people like it.  And you    │
  21.      │     can  have  a  copy  for  only  $25 (the basic shareware    │
  22.      │     charge plus $5).  That contribution pays  for  HOSP  as    │
  23.      │     well as some four dozen plus additional utilities, many    │
  24.      │     of  which  cover  territory nowhere else reviewed.  See    │
  25.      │     SHARE.TXT for details.  For preview,  try  most  recent    │
  26.      │     version  of  HOST  in  Library 1 of Compuserve's IBMBBS    │
  27.      │     Forum.  (Search for EYER or HOST)                          │
  28.      │                                                                │
  29.      └────────────────────────────────────────────────────────────────┘
  30.  
  31.  
  32.        WARNING: This program is  not  intended  to  be  run  in  drive
  33.        partitions larger than 32 megabytes.
  34.  
  35.  
  36.        Syntax
  37.        ------
  38.        DFAT [path cluster /V /S /P /Rxy] [>file]
  39.  
  40.        Parameters
  41.        ----------
  42.  
  43.        path       Drive/subdirectory on which to run DFAT.
  44.                   The default is the local directory.   This  parameter
  45.                   requires  the  use  of the colon in the drive name if
  46.                   DFAT is to recognise a different drive.  If you  want
  47.                   the  root  directory  and are not in it, just use the
  48.                   drive name without any backslash.
  49.  
  50.                   If a subdirectory is mentioned as a part of the path,
  51.                   it must begin with a backslash.  DFAT suppresses path
  52.                   defaults on other drives.  Do NOT  include  filenames
  53.                   or  wildcards  in  the path (DFAT will interpret them
  54.                   as directories, and so not find them).
  55.  
  56.                   A   little   experimentation   will   show  how  this
  57.                   parameter is used.
  58.  
  59.                   If  DFAT  is  made  to  operate  on  a nonexistent or
  60.                   unready drive, it will simply flip back to the  local
  61.                   drive  and  present  the appropriate disk report.  If
  62.                   the user's subdirectory does  not  exist,  DFAT  will
  63.                   report that fact.
  64.  
  65.                   Examples of syntactically valid paths:
  66.  
  67.                   D:
  68.                   d:\sys
  69.                   \SYS\CIS\
  70.                   c:\util\a
  71.  
  72.        cluster    The  first  cluster  number of the subdirectory to be
  73.                   viewed.  If not entered and if only drive information
  74.                   appears on the command line, DFAT simply presents the
  75.                   root  directory  from  which  the cluster numbers for
  76.                   subdirectories can be  obtained.
  77.  
  78.                   Use of a value for cluster  that  does  not  actually
  79.                   correspond  to any actual subdirectory causes DFAT to
  80.                   abort with an appropriate error message.
  81.  
  82.                   This  parameter  is  ignored  where the user enters a
  83.                   path containing valid subdirectory information.
  84.  
  85.        /V         Graph switch.
  86.                   When this switch is used, DFAT displays a map of the
  87.                   drive  selected,  instead  of the specific numerical
  88.                   statistics on  file  and  file  fragment  locations.
  89.                   Since  DFAT  also  picks  up  information  about the
  90.                   line-capacity of the video monitor (25,  43,  or  50
  91.                   lines),  it  automatically adjusts the scale used to
  92.                   represent clusters in the ASCII graphical  space  so
  93.                   as,  if  possible,  to fill just one screen with the
  94.                   map.
  95.  
  96.                   When using resolutions in excess  of  50  lines  per
  97.                   screen, use the /Rxy switch below.
  98.  
  99.                   The  output  is, naturally, redirectable so that the
  100.                   user  can  transmit  a  picture  of  his  drive   to
  101.                   someone else.
  102.  
  103.        /P         Pagination switch.
  104.  
  105.        /S         Short form.
  106.                   Where  activated,  this  switch  suppresses all video
  107.                   output except the final  disk  summary.   Useful  for
  108.                   including DFAT in AUTOEXEC.BAT.
  109.  
  110.        /Rxy       Enables user to override DFAT's internal line-
  111.                   detecting  routine.   For  example,  when  using   a
  112.                   60-line screen, this switch should read
  113.  
  114.                   /R60
  115.  
  116.                   No equals sign.
  117.  
  118.        [>file]    If the directory is very  long,  you  might  redirect
  119.                   DFAT  output to a file and view the result using your
  120.                   lister or editor.
  121.  
  122.        Note: parameter order is important.  If a path is mentioned,  it
  123.        must  be  listed  first  on  the command line.  Switches must be
  124.        mentioned last.
  125.  
  126.        Switches, however, may be mentioned together in any order.  For
  127.        example,  let us suppose you wish to use a 60-line screen and a
  128.        paginated graphics display for drive D.  The following  command
  129.        should then be used -
  130.  
  131.        DFAT D:/VPR60
  132.  
  133.        However, in most cases, internal resolution control should make
  134.        pagination unnecessary when using the graphics display.
  135.  
  136.  
  137.        Discussion
  138.        ----------
  139.        The  primary  purpose  of  this  program  is  to  measure   file
  140.        fragmentation  on  given  disks  taken as a whole, as well as to
  141.        show it in the  user's  selected  directory.
  142.  
  143.        The initial cluster of each file is not a fragment; where a file
  144.        is  fragmented,  its  fragments consist of those parts which are
  145.        not physically contiguous on the disk's tracks with that  file's
  146.        initial  cluster,  or  with  other  fragments  of the same file.
  147.        Thus, a file which is physically  integrated  by  DOS  from  two
  148.        discontiguous  media  images  is  said  to  have one "fragment".
  149.        Where a file has fragments, they are separated by a single space
  150.        in DFAT's listing.
  151.  
  152.        DFAT  counts  all  fragments on the disk (as recursively defined
  153.        above) and prepares a percentage evaluation shown  on  the  last
  154.        line  of video output.  This percentage is injected to DOS as an
  155.        errorlevel for batch file processing.
  156.  
  157.        Generally  speaking,  it's  time  to  defrag your disk, if DFAT
  158.        shows fragmentation percentages exceeding 15-30%, especially on
  159.        disks which show relatively  little  free  space.   Failure  to
  160.        respond  appropriately  to the buildup of file fragmentation is
  161.        one of the most common causes of drive failure.
  162.  
  163.        The  inspiration for DFAT was Chris Dunford's excellent FAT 1.09
  164.        (appearing in IBMSYS's Library 1 as FAT.ARC).  However, I needed
  165.        a program whose output looked more like a DOS directory.  I also
  166.        wished to extend the program to provide errorlevel output on the
  167.        percentage measure of  fragmentation,  much  as  does  PC  Mag's
  168.        interesting program CHKFRAG by Bob Flanders et al.
  169.  
  170.        I thought others would appreciate such revisions, as well.
  171.  
  172.        An  important  difference  between CHKFRAG and DFAT is that the
  173.        former  defines  fragmentation  in  terms  of  the  number   of
  174.        fragmented  files.   DFAT,  however,  counts what CHKFRAG calls
  175.        "extra sections" as fragments, without regard to how  they  are
  176.        distributed  among  files and subdirectories.  For this reason,
  177.        DFAT arrives at slightly different results.
  178.  
  179.        Changes in DFAT 2.6 (1/25/94)
  180.        ----------------------------
  181.        - Adds map-view function
  182.  
  183.        Changes in DFAT 2.5
  184.        -------------------
  185.        - Fixes bug that occasionally hung program on non-filename
  186.          directory noise.
  187.        - Adds file count statistic at bottom of list.
  188.  
  189.        Changes in DFAT 2.4
  190.        -------------------
  191.        - Contains part of logic needed to implement handling  of  drive
  192.          partitions larger than 32 megs (double integer arrays to store
  193.          large file allocation tables).
  194.  
  195.        - Fixes a limitation of earlier versions which did not allow for
  196.          fragmented    directory   listings   and   full   nesting   of
  197.          subdirectories.  The current version supports nesting of up to
  198.          32  subdirectories,  and  up  to  32  fragments   per   single
  199.          subdirectory listing.
  200.  
  201.        Changes in DFAT 2.2
  202.        -------------------
  203.        - Tests for total space on given logical drive; if in excess
  204.          of 32 megabytes, DFAT aborts to DOS with an appropriate  error
  205.          message.
  206.  
  207.        Changes in DFAT 2.1
  208.        -------------------
  209.        - Addition of pagination and short-form switches
  210.        - Cosmetic changes to effect briefer displays
  211.        - If neither path nor cluster number entered,
  212.           DFAT defaults directory to local directory
  213.           instead of root
  214.        - Increases subdirectory capacity
  215.        - Fixes bug which caused erroneous fragment counts
  216.           on small drives
  217.        - Largely fixes bug which caused string-allocation
  218.           hangs on some machines
  219.  
  220.        -------------------------
  221.        End of documentation
  222.